モバイルSuica決済 API一覧
※idPass版にのみ対応しています。json版には対応しておりません。
HTTP仕様(.idPass)
Request header |
Content-Type: application/x-www-form-urlencoded;charset=windows-31j |
|
---|---|---|
Method |
POST |
|
Response header |
Content-Type: text/plain;charset=windows-31j |
|
Status Code |
200:常に200を返却 |
EntryTranSuica 取引登録
これ以降の決済取引で必要となる取引IDと取引パスワードの発行を行い、取引を開始します。
ExecTranSuica 決済実行
お客様が入力した情報でJR東日本(Suicaセンター)と通信を行い決済を実施し、結果を返します。
リクエスト
AccessID |
必須
半角英数32桁 固定
取引ID【取引登録】で発行された値を設定します。 |
|
---|---|---|
AccessPass |
必須
半角英数32桁 固定
取引パスワード【取引登録】で発行された値を設定します。 |
|
OrderID |
必須
半角英数記号27桁
オーダーID【取引登録】で指定した値を設定します。 |
|
ItemName |
必須
全半角40桁
商品・サービス名
|
|
MailAddress |
必須
半角英数記号256桁
メールアドレスお客様の携帯メールアドレスを設定します。 |
|
ShopMailAddress |
半角英数記号256桁
加盟店メールアドレス
お客様へ結果通知メールを送信する際に同時に加盟店様にも送信する場合の
|
|
SuicaAddInfo1 |
全半角256桁
決済開始メール付加情報
|
|
SuicaAddInfo2 |
全半角256桁
決済完了メール付加情報
|
|
SuicaAddInfo3 |
全半角256桁
決済内容確認画面付加情報
|
|
SuicaAddInfo4 |
全半角256桁
決済完了画面付加情報
|
|
PaymentTermDay |
半角数字2桁
支払期限日数省略時は、ショップ情報に設定された支払期限日数で処理されます。 |
|
PaymentTermSec |
半角数字5桁
支払期限秒
最大86,400秒(1日)
|
|
ClientField1 |
全半角100バイト
加盟店自由項目1
|
|
ClientField2 |
全半角100バイト
加盟店自由項目2
|
|
ClientField3 |
全半角100バイト
加盟店自由項目3
|
|
ClientFieldFlag |
半角数字1桁 固定
加盟店自由項目返却フラグ
以下のいずれかを設定します。
|
/payment/ExecTranSuica.idPass
AccessID=tshop11223344&AccessPass=PASSWORD&OrderID=a6a6b0061347e90cdef806b39bd28705&ItemName=商品名&MailAddress=test@example.com
レスポンス
正常
OrderID |
半角英数記号27桁
オーダーID
|
|
---|---|---|
SuicaOrderNo |
半角英数40桁
Suica注文番号
|
|
ReceiptNo |
半角英数9桁
受付番号
Suica受付番号を返却します。
|
|
PaymentTerm |
半角数字14桁 固定
支払期限日時
お客様の払込期限を返却します。
|
|
TranDate |
半角数字14桁 固定
決済日付
決済依頼を実施した日時を返却します。
|
|
CheckString |
半角英数32桁
MD5ハッシュ
OrderID~TranDate+ショップパスワー
|
|
ClientField1 |
全半角100バイト
加盟店自由項目1
【決済実行】時に加盟店自由項目返却フ
|
|
ClientField2 |
全半角100バイト
加盟店自由項目2
【決済実行】時に加盟店自由項目返却フ
|
|
ClientField3 |
全半角100バイト
加盟店自由項目3
【決済実行】時に加盟店自由項目返却フ
|
OrderID=ORDER0000001&SuicaOrderNo=ORDER0000001-220527424343&ReceiptNo=1234567&PaymentTerm=20220607000734&TranDate=20220528000634&CheckString=12abcd11c2b95555d3cb1433c11111e9&ClientField1=加盟店自由項目1&ClientField2=加盟店自由項目2&ClientField3=加盟店自由項目3
ErrCode=E01&ErrInfo=E01040001
SearchTradeMulti 取引状態参照
指定したオーダーIDの取引情報を取得します。
レスポンス
正常
Status |
現状態
UNPROCESSED:未決済
|
|
---|---|---|
ProcessDate |
半角数字14桁 固定
処理日時yyyyMMddHHmmss書式 |
|
AccessID |
半角英数32桁 固定
取引ID
|
|
AccessPass |
半角英数32桁 固定
取引パスワード
|
|
Amount |
半角数字10桁
利用金額
|
|
Tax |
半角数字10桁
税送料
|
|
Currency |
通貨コード決済に利用された通貨を返却します。 |
|
ClientField1 |
全半角100バイト
加盟店自由項目1
|
|
ClientField2 |
全半角100バイト
加盟店自由項目2
|
|
ClientField3 |
全半角100バイト
加盟店自由項目3
|
|
PayType |
半角数字2桁
決済方法1:モバイルSuica |
|
SuicaReceiptNo |
半角英数9桁
受付番号
|
|
SuicaOrderNo |
半角英数49桁
Suica注文番号
|
|
PaymentTerm |
半角数字14桁 固定
支払期限日時yyyyMMddHHmmss書式 |
Status=REQSUCCESS&ProcessDate=20220527033418&AccessID=a6a6b0061347e90cdef806b39bd28705&AccessPass=5e0e54b892e14ed03e8cf807a6053813&Amount=1000&Tax=0&Currency=JPN&ClientField1=加盟店自由項目1&ClientField2=加盟店自由項目2&ClientField3=加盟店自由項目3&PayType=1&SuicaReceiptNo=6443582&SuicaOrderNo=ORDER0000001-220527424343&PaymentTerm=20220527235959&ErrCode=&ErrInfo=
ErrCode=E01&ErrInfo=E01040001